Inside Macintosh: QuickTime
The Movie Toolbox provides a set of functions that allow your application to create QuickDraw pictures from movies, tracks, and posters. This section discusses those functions.
You can use the GetMoviePict function to create a picture from a movie or its preview; you can use the GetTrackPict function to create a picture from a track. The GetMoviePosterPict function lets you create a picture that contains a movie's poster. If a movie or track has no spatial representation, the returned picture is empty--that is, the upper-left and lower-right coordinates are equal.
The GetMoviePict function creates a picture from the specified movie at the specified time. This function uses only those movie tracks that are currently enabled and would therefore be used in playback. Your application may call this function even if the movie is inactive.
pascal PicHandle GetMoviePict (Movie theMovie, TimeValue time);
The GetMoviePict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil .
You can use the GetMoviePict function to create a picture. If the movie contains compressed data, the picture created by this function may also contain compressed data that cannot be displayed without QuickTime.
If you want to create a picture from a movie's preview, put the movie into preview mode by calling the SetMoviePreviewMode function (described on SetMoviePreviewMode ), and then call the GetMoviePict function.
The GetMoviePosterPict function creates a picture that contains a movie's poster.
pascal PicHandle GetMoviePosterPict (Movie theMovie);
The GetMoviePosterPict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil .
The GetTrackPict function creates a QuickDraw picture from the specified track at the specified time. This function is similar to the GetMoviePict function (described on GetMoviePict ), except that GetTrackPict uses only the specified track to create the picture.
pascal PicHandle GetTrackPict (Track theTrack, TimeValue time);
The GetTrackPict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil .